Free API
JSON
CocktailDB
Support
The API and site will always remain free to access at its basic level.
Test Key
Use the test API key 1 during development or educational use.
For production use, sign up for Premium API if you are releasing publicly.
Contact
Email: [email protected]
Free Cocktail API Guide
Here are the main JSON endpoints for TheCocktailDB. They should work directly in a web browser or any API test tool such as postman or httpie. Most of the API is free, but we do offer a few premium calls for a one off upgrade.
Test key: 1
Base URL: www.thecocktaildb.com/api/json/v1/APIKEY/
Premium features available
V1 API Methods
Search cocktail by name
Search cocktail by first letter
Search ingredient by name
Lookup full cocktail details by id
Lookup ingredient by id
Lookup a random cocktail
Lookup a selection of 10 random cocktails
Premium API only (free limited to 1)
£10 lifetime upgradeList popular cocktails
Premium API only (free limited to 1)
£10 lifetime upgradeList most recent cocktails
Premium API only (free limited to 1)
£10 lifetime upgradeSearch by ingredient
Filter by multiple ingredients
Premium API only (free limited to 1)
£10 lifetime upgradeFilter by alcoholic category
Filter by category
Filter by glass
List categories, glasses, ingredients, or alcoholic filters
/api/json/v1/1/list.php?c=list
/api/json/v1/1/list.php?g=list
/api/json/v1/1/list.php?i=list
/api/json/v1/1/list.php?a=list
/api/json/v1/1/list.php?g=list
/api/json/v1/1/list.php?i=list
/api/json/v1/1/list.php?a=list
Premium access
Upgrading unlocks extra filter combinations, popular and recent lookups, the full database listing, and the latest/random image API methods.
Upgrading unlocks extra filter combinations, popular and recent lookups, the full database listing, and the latest/random image API methods.
Images
Drink thumbnails
Add /small, /medium, /large to the end of the cocktail image URL.
/images/media/drink/vrwquq1478252802.jpg (original)
/images/media/drink/vrwquq1478252802.jpg/small (200x200 px)
/images/media/drink/vrwquq1478252802.jpg/medium (350x350 px)
/images/media/drink/vrwquq1478252802.jpg/large (500x500 px)
/images/media/drink/vrwquq1478252802.jpg/small (200x200 px)
/images/media/drink/vrwquq1478252802.jpg/medium (350x350 px)
/images/media/drink/vrwquq1478252802.jpg/large (500x500 px)
Ingredient thumbnails
Add /small, /medium, /large to the end of the ingredient image URL.
/images/ingredients/Gin.png (original)
/images/ingredients/Gin.png/small (100x100 px)
/images/ingredients/Gin.png/medium (350x350 px)
/images/ingredients/Gin.png/large (700x700 px)
/images/ingredients/Gin.png/small (100x100 px)
/images/ingredients/Gin.png/medium (350x350 px)
/images/ingredients/Gin.png/large (700x700 px)
